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com.geps.util.ldsp 

Class BaseDirectoryAdapter 

3ava. lang .Object 

l 

f--coB.gttpA.util . Idap.BaseDirajctoryAdaptajr 



public abstract class BaseDirectoryAdapter 
extends java.lang.Object 
implements IBaseObjectCIass 

Class Description: 



Base class for all Directory Adapters. This class is abstract and cannot 
be instantiated. 



Field Summary 


protected 

DirectoryEntry 


m_dirEntry 


protected 
java.util .ArrayLiat 


in_modifi cat ions 



Constructor Summary 

BaseDirectoryAdapter ( } 



Method Summary 


DirectoryEntry 


getDirEatryO 

Desc: Use to get the DirectoryEntry from the adapter. 


3 ava . ut i 1 . ArrayLi • t 


getModif ications ( ) 

Desc: Use to get the list of Modification! tem(s) applied to the adapter. 


protected void 


ini tial i a e { pi r e c t ory En t ry de ) 
Desc: Used to initialize the adapter. 



Methods inherited from class java.lang.Object 

, clone, equals! finalize, getClass, hashCode, notify, notifyAll, registerNatives , toString, 
wait, wait, wait 



Field Detail 



m_dirEntry 
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m_modifications 

protected java. util . ArrayLiat «_modif icatioaa 

Constructor Detail 

BaseDirectory Adapter 

public BaaaDiractoryAdaptar ( ) 

Method Detail 

initialize 

protected void initiali»« {p,i rectory Entry de) 

throws j avax * naming .NamingExcep t ion 

Desc: Used to initialize the adapter. This is used by com.geps.util.ldap.DirectoryManager when its getAdapterlnstanceQ 

method is called. 

Parameters: 

de - DirectoryEntry to initialize adapter with. 



Un - ^aseDirectoryAaapter ^ m 

protected DirectoryEntry tt_dirbtry 



getDirEntry 

public DirectoryEntry gatDirtotry ( ) 

Desc: Use to get the DirectoryEntry from the adapter. 
Specified by: 

getDirEntry in interface IBaseObjectClass 
Returns: 

Returns the DirectoryEntry associated with the adapter. 



getModifications 

public java. util. ArxayLiBt gatHodlf icatiooa 0 

Desc: Use to get the list of ModificationItem(s) applied to the adapter. This method should not be used by clients. It is used 
by com.geps.utiUdap.DirectoryManager. 
Specified by: 

getModificauons in interface IBaseObjectClass 
Returns: 

Returns the list of Modificationltcm(s). 
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PREV CLASS NEXT CLASS 

SUMMARY* INNER | FlgUO | CQNSTR | METHOD 

com.geps.uclJ.idap 

Class DirectoryEntry 

java . lang .Object 

i 

+- -coa.gepe .util . ldap.Directorytotry 



public class DirectoryEntry 

extends java.lang.Object 

Clasa Description: 



FRAMES NO FRAMES 

DETAIL FIELD | C0NSTR I METHOD 



Simple wrapper which represents a DirContext. 



Field Summary 


private java. lang .String 


m_dn 


private 

3 avax . naming . directory . DirContext 


m — entry 



Constructor Summary 

DirectorySntry { j avax . naming . directory . DirContext entry) 
Desc: Constructor. 



Method Summary 


j avax naming. directory. DirContext 


getDirCtx ( ) 

Desc: Use to retrieve the entry. 


3 avm . lang . String 


tost ring ( ) 

Desc: Override toStringQ. 



Methods inherited from claai JavaJing.ObJect 

, clone, equals, finalise, getClaaa, hashCode, notify, notifyAll, registerNatives, wait, wait, 
wait 



! Field Detail 
m_dn 

private java. lang. P^-ing m_da 
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m_entry 

private j avax. naming, dire ctory.DirCon text »_«ntry 



Constructor Detail 



DirectoryEntry 

public D±r«etoryKntry (3 avax. naming .direct ory.DirContaxt entry) 
Desc: Constructor. 



Method Detail 



getDirCtx 

public javax. naming. directory. DirContext gatDirCtacO 

Desc: Use to retrieve the entry. 
Returns: 

Returns the entry. 



toString 

public java.lang.String toString {} 

Desc: Override toStringO- 
Overrides: 

toString in class java.iang.Object 
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FREV CLASS NEXT CLASS 

SUMMARY: INNER | FIELD | CONSTR | METHOD 



com.geps.utUJ dap 

Class DirectoryManager 

-java. lang. Object 

i 

+ - -com . g«p» * util . Idmp . Dir«ctoryManag«r 



public abstract class DirectoryManager 
extends java.lang. Object 

Class Description: 

This class represents the Directory Framework in which clients will interface 
with to request Directory En try and object class adapters and to write 
entry modifications back to LDAP. 



Field Summary 


private static java.lang. String 


a_adapterPkg 


private 

static j avax. naaing. di rectory. Initials trConcaxt 


a_ctx 



Constructor Summary 

DirectoryManager { ) 



Method Summary 


(package private) 
static void 


0 


private 

static java.lang. String 


axtractLdapOb jClaaaNaaa { java .lang . String name) 

Desc: Helper which extracts the object class name from the specified 'name'. 


static Baf^DirectojcyA4«Bfi»i: 


SiL^4*pt«?a«tajice(DirectoryEntry entry, j ava, lang. String adapterName) 
Desc: Use to obtain the specified 'adapterName' adapter from the specified 'entry'. 


static j ava . util .Array List 


getAdapt«ra(DirectoryEntry entry) 

Desc: Use to obtain a list of all adapters that the specified 'entry 4 is composed of. 


static DirectoryEntry. 


c/etEatry (IBaseObiectClass adapter) 

Desc: Use to get DirectoryEntry from the specified 'adapter'. 


static EirectoryEncry 


lookup (j ava. lang. String dn) 

Desc: Retrieves the DirectoryEntry whos key matches the the specified 'dn\- 


static Java.util.ArrayList 


•earch< java. lang. String ctxToSearch, j ava. lang. St ring filter) 
Desc: Use to exeevtw a query against the Directory. 



FRAMES NO FRAMES 

DETAIL* FIELD | CONSTR | METHOD 
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•CAClC void 



writ«(IBaseObiectClass adapter) 

Desc: Use to wnte out the contents specified by 'adapter 1 to LDAP. 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives. toStnng, 
wait, wait, wait 



Field Detail 

S_Ctl 

private static j avax. naming .directory . InitialDirContext s_ctx 



s_adapterPkg 

private static java. lang. String a_adaptarPkg 



Constructor Detail 



DirectoryManager 
public DiractoryXanagar () 



Method Detail 



lookup 

public static Directory Entry lookup (java . lang. String dn) 

throws j avax . naming . NamingExcept ion 

Desc: Retrieves the DirectoryEntry whos key matches the the specified 'dn\ 
Returns: 

DirectoryEntry associated with the specified 'dn*. 
Throws: 

javax.naming.NamingExccption - If a naming exception occurs or if lookup did not return object of type 
DirContext 



getAdapterlnstanee 

public static BaseDirectoryAdapter gatAdaptarZnstanca (DirectoryEntry entry, 

j ava . lang . String adapt erName ) 
throws j avax. naming. NamingExcept ion, 

java. lang. ClassNotFoundException, 
j ava . lang . InstantiationException , 
j ava . lang . UlegalAccessExcept ion 

Desc: Use to obtain the specified 'adapterName* adapter from the specified 'entry*. If the requested 'adapterName' is not an 

object class of 'entry', a null will be returned. 

Parameters: 

entry - DirectoryEntry in which to search 
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Returns: 

The adapter representing the object class specified by 'adapterName* from the DirectoryEntry 'entry 1 
returned if the specified 'adapterName' is not an object class of the specified 'entry 1 . 
Throws; 

javax.naming.NamingException - If a naming exception occurs. 



getEntry 

public static DirectoryEntry gatlntry (IBaseOb^ectClass adapter) 

Dcsc: Use to get DirectoryEntry from the specified 'adapter*. 
Parameters: 

adapter - The adapter to get the DirectoryEntry from. 
Returns: 

The DirectoryEntry for the specified 'adapter*. 



write 

public static void writ* (iBaseObjectClass adapter) 

throws javax . naming . NamingException 

Desc: Use to write out the contents specified by 'adapter* to LDAP. 
Parameters: 

adapter - Object Class to wnte out. 



getAdapters 

public static java.util .ArrayList gatAdaptara (DirectoryEntry entry) 

throws javax.naming.NamingException 

Desc: Use to obtain a list of all adapters that the specified 'entry is composed of. Each adapter name returned can be 
passed into DirectoryManager.getAdapterlnstanceCDirectoryEntry, String) as the 2nd parameter to obtain an adapter 
instance. 
Parameters: 

entry - DirectoryEntry in which to discover all adapters for. 
Returns: 

on-null ArrayList of String adapters names. 



search 

public static java.util. ArrayList aaarch{ java.lang. String ctxToSearch, 

java. lang. String filter) 
throws j avax . naming .NamingException 

Desc: Use to execute a query against the Directory. 
Parameters: 

ctxToSearch - Context to search. ,m for current context 
filter - LDAP filter. 
Returns: 

List of DirectoryEntries resulting from the query. Only DirContext objects are supported so if the query returns 
objects other than DirContext, they will not be in the List. 



. null is 
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extractLdapObjCIassName 

private static java . lang. String axtractLdapObjClaaaHaa* ( java.lang.String name} 

Desc: Heiper which extracts the object class name from the specified *name\ 'name* looks like 
M com.geps.ldap.PocuserAdapter M . This method removes all package names the " Adapter" suffix is stripped and the 
remaining string returned. 
Parameters: 

name - Adapter names which are defined constants in DirectoryConstants or the object class name itself. 
Returns: 



Return* ne LDAP object class name. 



static void () 



Class Tree Deprecate d Index Help 

PREV CLASS NEXT CLASS 

SUMMARY: INNER i FIELD | CONSTR | METHOD 



FRAMES NO_FRAME3 

DETAIL FIELD | CONSTR | METHOD 
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FRAMES MO FRAMES 

DETAIL: FIELD | CONSTR | METHOO 



com.gepi.ntiJ.ldap 

Class Generator 



java . lang. Object 

I 

*--coa.g«pfl .uti 1.1 dap. Genera tor 

public abstract class Generator 
extends java.lang. Object 

Class Description: 

This class is used to generate java interfaces and adapters which represents 
LDAP object classes. For each LDA? object class there is one java interface 
and one java adapter. This class also generates the file DirectoryConstants 
which provides defined constants used to identify adapters. These classes \ 
are used in the java LDAP Directory framework. This class is abstract so 
it cannot be instantiated. 



Inner Class Summary 


private 
static class 


Generator .NBP 

Desc: Helper class, Name Boolean Pair. ( 



Field Summary 


private static 3 av*. lang .String 


«_copyRightYear 


private static javs. 1*09. String 


»_dateGemerated 


private static java. lang. St ring 


•_DirConatNaae 


private static java. lang. String 


e_g«nSrcPmth 


private 

stat 1c j avax . naming . directory . InitialDirContext 


«_initDirCtx 


privets static java.lang. String 


»_m\iltiSuf f ix 


private 

static javax . naming . directory . Di rContext 


■_scheaaRoot 


private static java.lang. String 


»_arcPathRoot 


private static java.lang. St ring 


s^ircPJcg 


private static java.lang .String 


•_ts 



file://C:\Projects\ge\framewoM^ ^r! 12/13/. 



: uiass Ueneracor 



Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS 

SUMMARY: INNER | FIELD 1 CONSTR | METHOO 



: cuss uenerator 



f age i ot 1 1 



Constructor Summary 

Generator ( ) 



Method Summary 


(paekag* private) 
static void 


0 


private ststic void 


addAttrNameToLia t (java . util .TreeSet store, 
3 avax . naming . NamingEnumeration vals ) 
Desc: Add attribute names to a TreeSet. 


private static void 


•mitAdapter (java. lang. String oc, 3ava .util .TreeSet [) attrNames, 
3 ava - . PrintStream out) 

~esc: Generates the adapter class for the specified object class. 


private itatic void 


emitAdapterClaMBody (3 ava. lang. String oc, java. util .TreeSet [] attrNames, 
Desc: Writes the body of the adapter. 


private static void 


bMMp&Vii kbwii \ Java * Uwii « i i> CC JC i» attidCt , J ava . 10 . r L J. II o l_ tccliTl OUv. / 

Desc: For the specified 'attrSef will generate getters for all attributes contained within for the 
adapter. 


private static void 


ami t -lap tar Imports ( j ava . io . PrintStream out ) 
^esc: Writes the import statements for the Adapter. 


private static void 


Desc: Writes the adapter name and opening curley. 


private static void 


eaitAdaptarSetter* (java. util .TreeSet attrSet, java. io. PrintStream out) 
Desc: Generate adapter setters for attributes. 


private static void 


•ai^dapt«rTqString ( java . util . TreeSet [ J attrNames , 3 ava . io . PrintStream out) 
Desc: Writes out the adapters toStringO method. 


private static void 


ami tAdap 1 terToSjtringHelper ( j ava .10. PrintStream out ) 
Desc: Writes out the adapters toStringO helper method. 


private static void 


amitAllAdaptarOattara (java. util .TreeSet [1 attrNames, 
j ava . io . PrintStream out ) 

Desc: Writes out all adapter getters for both required and optional attributes. 


private static void 


amitAHAdaptarSattara (java. util .TreeSet [3 attrNames, 
java. .d. Print Stream out) 

Dm/** WritM rutt nil arlanter c#»tt#»rQ Yrvr koth r#viii \r~A atiH n rational attributes 


private static void 


•mi tAllInt«rfaceGetter» (lava. util. TreeSet 13 attrNames, 
j ava . io . Print Stream out ) 

Desc: Writes out all interface getters for both required and optional attributes. 


private static void 


•mi tAl 1 Int«rf_ac«S« 1 1 er s ( 3 ava .util. Tr e eS e t U a 1 1 rName s , 
java. io. PrintStream out) 

Desc: Writes out all interface setters for both required and optional attributes. 


private static void 


•mi tCloaingClaa«Brac)cet ( j ava . io . PrintStream out } 
Desc: Writes the class closing curley. 


private static v-id 


•oitCoscmantHftadsr ( java. 10. PrintStream out) 
Desc: Writes the comment header for the file. 


private static void 


•mitpirConat ( j ava . lang .String className , j ava . io. PrintStream out) 
Desc: Write out adapter constant for the specified 'className'. 


private static void 


ami tpir Cons tNass ( j ava . io . PrintStream out ) 

Desc: Writes the interface name and opening curley. f 
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pnvaca ataxic void 


«n± to* t FramModl f iedCache ( j ava . io . Pr int S t ream out: ) 
Desc: Writes out getFromModifiedCache method. 


privata static void 


emitlntarf ace ( java.lang. String oc, java.util .TreeSet [] attrNames, 
java.io.PrintStream out) 

Desc: Generates the interface class for the specified object class. 


private static void 


emitlntarf aceCla»«Body ( }ava .util .TreeSet [] attrNames , 
j ava . io . Print St ream out ) 

Desc: Writes the body of *e interface. 


private static void 


•mitlnterfaxceGettere { ja\ ^til. TreeSet attrSet, j ava . 10. Prints tream out} 

Desc: For the specified attrSet' will generate getters for all attributes contained within for the 
interface. 


private static void 


emitlnterf acslmp rt« £ java. io . PrmtStream out) 

uesc. wnies uiv tmpon statements ior tne intenace. 


private static void 


emitlnterf aceName (java. lang. String oc, java.io.PrintStream out) 
Desc: Wntes the interface name and opening curley. 


privata static void 


eai t Inter facaSetter»( 3 ava. util. TreeSet attrSet, java.io.PrintStream out) 

Desc: For the specified 'attrSet' will generate setters for all attributes contained within for the 
interface. 


private static void 


•mi tPackage ( j ava . io . PrintStream out ) 
Desc: Writes the package statement 


private static void 


generate ( j ava . lang . String [ 1 cb j Classes ) 

Desc: Directs the generation of interface and adapter classes. 


private static void 


getxt tribute* (java. lang. St ring oc, java.util .TreeSet mandatory, 
java.util .TreeSet optional) 

Recursively extracts all attributes for the specified 'oc' and all attributes of W superclasses. 


private 

static java.util .Tre«S«t 

n 


getAt trList (java .lang.St ring oc) 

Desc: Create a list of required and optional attribute names for the specified 'oc' object class 
and all attributes of 1 oc* super object classes and so on by looking up these values in the LDAP 
Schema. 


private 

static java.lang. String 

n 


ge tObj Cla» «e« { ) 

Desc: This method will query LDAP to get all object class names and returns those names in an 
array ox strings. 


private static void 


initialize ( ) 

ucsc. oets requires system properues t ngures out wncrc io create me gcneraica iucs. 


static void 


main (java. lang. String [] arga) 
Desc* Prosr&m entrv do int 


private static void 


•hutDqwn ( ) 

Desc: Release any remaing resources. 



Methods inherited from class javaUang.Object 

clone, equals, finalize, getClass, bashCode, notify, notifyAll, regis terNatives, toString, 
wait, wait, wait 



Field Detail 



s_multiSufitr 

private static final java. lang. St ring a_aultiSuf f ix 
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s_ts 

private static java.lang.String »_ta 



s_DirConstName 

private static final java.lang.String s^DirConstNaaa 

s_srcPathRoot 

private static java.lang.String «_«rcPathHoot 

sjjenSrcPath 

private static java.lang.String a_gan3rcPath 

s_srcPkg 

private static java.lang.String s_arcP)cg 

sJnitDirCtx 

private static j avax. naming. directory . InitialDirContext »_iaitDirCtx 
s_schemaRoot 

private static j avax. naming, directory. DirContext a_acfaamaJlo©t 

sdateGenerated 

private static java.lang.String s_d*t*0«narat«4 

s_copyRightYear 

private static java.lang.String ■_copy*ightY«ax 

Constructor Detail 

Generator 

public GanaratorO 
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Method De^il 



main 

public static void main ( java. lang. St ring [] args) 

Desc: Program entry point. If an object class name does not exist, an error message will be generated and processing 
continued. 

Parameters: 

args - Array of parameters. If the value of args[0].equals( M ALL"), then interfaces/adapters will be generated for all 
object classes in the LDAP. Any further arguments are ignored. But if the value of args[0] is not equal to "ALL", 
then the arguments are expected to be LDAP object class names. Each name passed in will be processed and a 
resulting interface/adapter will be generated. 



initialize 

private static void initialise {) 

throws j a va . 1 ang . Except ion 

Desc: Gets required system properties, figures out where to create the generated files. 



generate 

private static void g ana rat • (java. lang. String [] objClasses) 

throws java. lang. Except ion 

Desc: Directs the generation of interface and adapter classes. Interfaces are prefixed with an "I" and adapters are suffixed 
with "Adapter". Also creates a file which contains constant strings used to identify object classes. 



emitlnterface 

private static void ami tlntarfaca (java. lang. St ring oc, 

java.util .TreeSet [] attrNames, 
java. io .Prints t ream out) 
throws j avax . naming . NammgExcept ion 

Desc: Generates the interface class for the specified object class. 
Parameters: 

oc - Object Class to generate interface for. 

attrNames - Array of TreeSet object containing the required and optional attribute names. Required is at index 0* 
optional at index 1. 
out - Stream to write to. 



emitAdapter 

private static void amitAdaptar (java. lang. String oc, 

java.util. TreeSet [] attrNames, 
java. 10. Print St ream out) 
throws j avax . naming . NamingException 
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Desc: Generates the adapter class for the specified object class. 
Parameters: 

oc - Object Class to generate adapter for. 

attrNaraes - Array of JreeSet object containing the required and optional attribute names. Required ts at mcex 0. 
optional at index 1. 
out - Stream to write to. 



emitCommentHeader 

private static void *mitCoa«i«ntH«ad«r ( j c -a . 10 . PrmtStream out) 

Desc: Wntes the comment header for the file. 
Parameters: 

out - Stream to write to. 



emitPackage 

private static void nitPackaga ( java.io.PrintStream out J 

Desc: Writes the package statement. 
Parameters: 

out - Stream to write to. 



emitlnterfacelmports 

private static void ami tlntarfiacalaporta (java. io . PrintSt ream out) 



Desc: Writes the import statements for the Interface. 
Parameters: 

out - Stream to write to. 



emitAdapterlmports 

private static void amitAdaptarls^orts (java. io. Prints t ream out} 

Desc: Writes the import statements for the Adapter. 
Parameters: 

out - Stream to write to. 



emitlnterfaceName 



private static void mm! tlntarfiacaNaa* (java. lang. String oc, 

java.io.PrintStream out) 



Desc: Writes the interface name and opening curley. 
Parameters: 

oc - Object class name, 
mt - Stream to write to. 
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emitAdapterName 

private static void *aitAdapterNa»e (java. lang. String oc, 

3 a va. io.PrintStream out) 



Desc: Writes the adapter name and opening curley. 
Parameters: 

oc - Object class name. 

out - Stream to write to. 



emitDirConstName 

private static void eoitDirConstHaM (java . io.PrintStream out) 

Desc: Writes the interface name and opening curley. 
Parameters: 

oc - Object class name. 

out - Stream to write to. 



emitlnterfaceClassBody 

private static void emitlnterf aceClassBody ( java.util » TreeSet [) attrNames, 

java. io.PrintStream out) 
t hrows j avax . naming . Naming Except ion 



Desc: Writes the body of the interface. 
Parameters: 

attrNames - An array of TreeSet objects containing the required and optional object class attribute names. 
TreeSetfO] » requried, TreeSet[l] ~ optional, 
out - Stream to write to. 



emitAdapterClassBody 

private static void ami tAdaptarClaasBody( java . lang. String oc, 

java.util .TreeSet [] attrNames, 
java . io.PrintStream out) 
throws j avax . naming . Naming Except ion 



Desc: Writes the body of the adapter. 
Parameters: 

oc - Object class name. 

attrNames - An array of TreeSet objects containing the required and optional object class attribute names. 
TreeSet[0] » requried, TreeSetfl] = optional, 
out • Stream to write to. 



emitAllInterfaceGetters 

private static void eaitAllXntarf aceOttters (java.util .TreeSet [] attrNames, 

java. io.PrintStream out) 

Desc: Writes out all intfface getters for both required and optional attributes. 
Parameters: 

i >■> - . in array of TreeSet containing the required and optional attribute names. 
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out - Stream to write to. 



emitAUInterfaceSetters 

private static void «aitxlllnt»r£»c#fl«tt«r« ijava.util .TreeSet [] attrNames, 

3 ava. io. PrintStream out) 

Desc: Writes out all interface setters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAllAdapterGetters 

private static void *mitAllAdapt«rO«tt«r» (java.util .TreeSet [] attrNames, 

java. io. Print Stream out) 

Desc: Writes out all adapter getters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAllAdapterSetters 

private static void «aitAllAdapt«rS«tt«r» (java.util .TreeSet [] attrNames, 

j ava . io . PrintStream out ) 

Desc: Writes out ail adapter setters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitlnterfaceGetters 

private static void emit Int«r£ac«0«ttera (java .util .TreeSet attrSet, 

j ava. io. PrintStream out) 

Desc: For the specified 'attrSef will generate getters for all attributes contained within for the interface. 
Parameters: 

attrSet - Set of attribute names to generate getters for. 
out - Stream to write to. 



emitlnterfaceSetters 

private static void «aitlnt«r£»c«flett«r» (java. util. TreeSet attrSet, 

java. 10. Print St ream out) 

Desc: For the specified 'attrSef will generate setters for all attributes contained within for the interface. 
Parameters: 

attrSet - Set of attribute names to generate setters for. 
out - Stream to write to. 
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emitAdapterSetters 

private static void «mitAdapter8«tt«r» ( java .util .TreeSet attrSet, 

java .io.PrintStream out) 

Desc: Generate adapter setters for attributes. 
Parameters: 

attrSet - Set of attribute names to generate setters for. 
out - Stream to write to. 



emitAdapterGetters 

private static void ami tAdaptarG«ttara (java. util .TreeSet attrSet, 

java.io . Prints t ream out) 

Desc: For the specified *attrSet' will generate getters for all attributes contained within for the adapter. 
Parameters: 

attrSet - Set of attribute names to generate getters for. 
out - Stream to write to. 



emitGetFromModifiedCache 

private static void «mitO#tFroBaModifi«dCacb« (java. io. Print St ream out) 

Desc: Writes out getFromModifiedCache method. This is a getter helper method which looks into the modified cache for 

changes. 

Parameters: 

out - Stream to write to. 



eraitAdapterToString 

private static void «mitAdaptaxToStriag (java. util .TreeSet {) attrNaroes, 
J java. io.PrintStream out) 

Desc: Writes out the adapters toStringO method. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAdapterToStringHelper 

private static void •oitAdapttrTostringKtlptr < java. io.PrintStream out) 

Desc: Writes out the adapters toStringO helper method. 
Parameters: 

out - Stream to write to. 



emitDirConst 
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private static void «m±tDirConst (java.lang. String className, 

java.io. Print St ream out) 

Desc: Write out adapter constant for the specified 'className'. 
I Parameters: 

j className - Object class name to write constant for. 

out - Stream to write to. 



eraitClosingClassBracket 

private static void •aitClo»iagClassBrack«t (java.io. Prints tream out) 



Desc: Writes the class closing curley. 
Parameters: 

out - Stream to write to. 



shutDown 

private static void shutDown 0 

throws j avax . naming . NamingException 

Desc: Release any remaing resources. 



getObjClasses 

private static java.lang* String [] gstObjClassss 0 

throws j avax . naming ♦ NamingException 

Desc: This method will query LDAP to get all object class names and returns those names in an array of Strings. 
Returns: 

Returns an array of Strings containing all object class names. 
Throws: 

javax.rianung.NamingException - If a naming exception occurs. 



getAttrList 

private static java.util .TreeSet [} gatAttrList ( java.lang. St ring oc) 

throws j avax , naming . NamingException 

Desc: Create a list of required and optional attribute names for the specified 'oc' object class and all attributes of 'oc' super 
object classes and so on by looking up these values in the LDAP Schema. Along with each attribute name is a boolean flag 
which indicates if the attribute is single valued or not. Returns this information in an array of TreeSet objects. The first 
element in the array contains the required attributes and the second element contains the optional attributes. The elements 
in contained in the TreeSet are Generator.NBP objects (Name Boolean Pair). The name is the attribute name and the 
boolean indicates if it is single valued or not 
Parameters: 

oc - Object class name to build attribute list for. 
Returns: 

Array of TreeSet containing the required and optional attributes. 



getAttributes 
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private static void gmtxt tribute (java.lang. String oc. 



java.ut 11. TreeSet mandatory, 
java.util. TreeSet optional) 
throws javax . naming .Naming Except ion 



Recursively extracts all attributes for the specified 'oc* and all attributes of 'oc' superclasses. 
Parameters: 

oc - Object class name in which to extract attributes for. 
mandatory - TreeSet to store mandatory attributes, 
optional - TreeSet to store optional attributes. 



addAttrNameToList 

private static void addAttrKaaaToLiat (java . util .TreeSet store, 

javax. naming . NamingEnumeration vals) 
throws j avax. naming . Nana ngExcept ion 

Desc: Add attribute names to a TreeSet TreeSet does not allow dups. For each attribute Vais\ this method also determr.ss 
if that attribute is single or multivalued. The attribute name and whether it is single valued or not is added to 'store 1 as 
Generator.NBP (Name Boolean Pair) object. 
Parameters: 



store - TreeSet to store attribute names 
vals - Enumeration of attribute names 



static void 0 
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Class Tree Deprecat ed I ndex Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 
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com.geps.utll.ldap 

Class Generator.NBP 

j *v» . lang . Obj ect 

I 

+ - -con. gap* . util . ldap .Ganarator .HBP 

Enclosing class: 

Generator 



private static class Generator.NBP 
extends java.lang.Object 
implements java.lang.Comparable 

Desc: Helper class, Name Boolean Pair. Holds attributeName, isSingle boolean pair. 



Field Summary 


j*v» . lang .String 


m_attrHa»a 


boolun 


m_i«S±ngla 



Constructor Summary 

G«n«r«tor .HBP (java.lang. String attrName, boolean isSingle) 



Method Summary 


inc 


canpareTo (java.lang.Object obj) 



Methods inherited from class javaJang.Object 

, clone, equals, finalize, getClass, hashCode, notify, notifyAll, regie terNativea, toString, 
wait, wait, wait 



Field Detail 

m_attrName 

public java.lang. String »_attrNaae 
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mJsSingle 

public boolean a_i»Singli 



Constructor Detail 



Generator.NBP 

public Generator. KB? (java.lang. String attrName, 
boolean isSingle) 



Method Detail 



corapareTo 

public int compareTo { java.lang. Object ob j ) 

Specified by: 

compareTo in interface Java. lang.Comparable 
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Class Tree Deprecated Index Help 

PREV CLASS NEXT CUSS 

SUMMARY: INNER ) FIELD ) CONSTR | MgTHQD 

com.seps.udl.ldap 

Interface EBaseObjectClass 

Ail Known Implementing Classes: 

BaseDirectoryAdapier 

public interface IBaseObjectClass 

Class Description: 

Base interface for all object class interfaces. 



Method Summary 


D 1 rpctory Entry 


getDirtotry () 


j av* . ut ll . AxrmyList 


g«tModi£±cafcion» ( ) 



Method Detail 

getModifications 

public java.util.ArrayList gatatodlf icationa () 



getDirEntry 

public Directory Entry gstDirlntryO 



Class Tree Deprecated Index Help 

PREV CLASS NEXTCUAS5 
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com.geps.utiLldap 

Class Util 

j ava * lang . Ob j ect 

I 

*- - coo. gaps. util. 1 dap. Util 

public abstract class Util 
extends java.lang.Object 

Class Description: 

Utility methods used by classes in the com. geps .util . Idap package. This 
class is abstract and cannot be instantiated. 



Field Summar 


Y 


Static 3 avi. long. String 


ADAPTRR_SOTFIX 


•catic java.lang. String 


IKTSRPAC_K_PRBriX 



Constructor Summary 

UtilO 



Method Summary 


•tatic 3 ava. lang. string 


conv«rtToValidK«tbodMam« ( j ava . lang . String str 

Desc: Will return a string with the same contents of 'str out with the 1st character uppcrcascd, 
the rest of the characters lower case and any to *J- 



Methods inherited from clan JavaJapg.ObJect 

, clone, equals, finalize, getClaaa, hashCode, notify, notifyAll, regis terNatives, toString, 
wait, wait, wait 



Field Detail 



INTERFACEJPREFIX 

public static final j ava. lang. String IMTlJUrxCt_PlttFIX 



WIIES NO FRAMES 

DETAIL FIELD I CONST* I METHOD 
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Overview Pa ckage Class Use Tree Deprecated Index Help 



Java™ 2 Platform 
Std Ed vl.3 




java.lang. reflect 



Class Proxy 




i ava . lanq . Ob~ ecr 

+- - java . lang . reflect . Proxy 

AH Implemented Interfaces: 

Serializable 



public class Proxy 
extends Object 
implements Serializable 

proxy provides static methods for creating dynamic proxy classes and instances, and it is also the superclass of all 
dynamic proxy classes created by those methods 

To create a proxy for some interface Foo. 

InvocationHandler handl -r - new MylnvocationHandier ( . . . j ; 
Class proxyClass = Proxy . getProxyClass ( 

Foo . class . getCl ass Loader ( j , new Class [] { Foo.cl ss }); 
Foe f = (Foo) proxyClass. 

getConstructor { new Class[] { InvocationHandler . class }). 

newlns tance (new Object [] { handler }); 

or more simply. 

Foo f = 'Foo} Proxy . newProxylns tance ■ Foo . class . getClassLoader f ) , 

new Class [] { Foo. class }, 
handler ) ; 



A dynamic proxy class (simply referred to as a proxy class below) is a class that implements a list of interfaces 
specified at runtime when the class is created, with behavior as described below. A proxy interface is such an 
interface that is implemented by a proxy class. A proxy 9 instance is an instance of a proxy class. Each proxy instance 
has an associated invocation handler object, which implements the interface Inv ocationHandler . A method 
invocation on a proxy instance through one of its proxy interfaces will be disp *;ed to the invoke method of the 
instance's invocation handler, passing the proxy instance, a j ava . lang . re fie Method object identifying the 
method that was invoked, and an array of type object containing the arguments. The invocation handler processes 
the encoded method invocation as appropriate and the result that it returns will be returned as the result of the 
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method invocation on the proxy instance. 
A proxy class has the following properties 

• Proxy classes are public, final, and not abstract 

• The unqualified name of a proxy class is unspecified The space of class names that begin with the string 
M s Proxy" should be, however, reserved for proxy classes 

• A proxy class extends java.lang. reflect. Proxy. 

• A proxy class implements exactly the interfaces specified at its creation, in the same order 

• If a proxy class implements a non-public interface, then it will be defined in the same package as that interface 
Otherwise, the package of a proxy class is also unspecified. Note that package sealing will not prevent a prox> 
class from being successfully defined in a particular package at runtime, and neither will classes already defined 
in the same class loader and the same package with particular signers. 

• Since a proxy class implements all of the interfaces specified at its creation, invoking getincerf aces on its 
class object will return an array containing the same list of interfaces (in the order specified at its creation), 
invoking getMethods on its class object will return an array of Method objects that include all of the methods 
in those interfaces, and invoking getMethod will find methods in the proxy interfaces as would be expected 

• The Proxy. isProxyciass method will return true if it is passed a proxy class-- a class returned by 

Proxy. getProxyciass or the class of an object returned by Proxy.newProxyinstar.ee- and false otherwise 

• The java . security . ProtectionDomain of a proxy class is the same as that of system classes loaded by the 
bootstrap class loader, such as j a va. lang .object, because the code for a proxy class is generated by trusted 
svstem code This protection domain will typically be granted java. security .AiiPerrr.ission 

• Each proxy class has one public constructor that takes one argument, an implementation of the interface 
i nvocationHandier , to set the invocation handler for a proxy instance. Rather than having to use the 
reflection API to access the public constructor, a proxy instance can be ilso be created by calling the 
Proxy. newinstance method, which combines the actions of cal* :g Proxy, get Proxyciass with invoking the 
constructor with an invocation handler 

A proxy instance has the following properties 

• GK en a proxy instance proxy and one of the interfaces implemented by its proxy class Foe, the following 
expression will return true: 

proxy instanceof Foo 

and the following cast operation will succeed (rather than throwing a ciassCastException)' 

(Foo) proxy 

• Each proxy instance has an associated invocation handler, the one that was passeG co its constructor. The static 
Proxy, qetinvocationHandler method will return the invocation handler associated with the proxy instance 
passed as its argument. 

• An interface method invocation on a proxy instance will be encoded and dispatched to the invocation handler's 
invoke method as described in the documentation for that method. 

• An invocation of the hashcode, equals, or tostnng methods declared in java . lang. object on a proxy 
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instance will be encoded and dispatched to the invocation handlers invoke method in the same manner as 
interface method invocations are encoded and dispatched, as described above The declaring class of the 
Method object passed to invoke will be java. lang. obiect Other public methods of a proxy instance 
inherited from java. lang. object are not overridden by a proxy class, so invocations of those methods 
behave like they do for instances of java. i a ng. object. 

Methods Duplicated in Multiple Proxy Interfaces 

When two or more interfaces of a proxy class contain a method with the same name and parameter signature, the 
order of the proxv class's interfaces becomes significant When such a duplicate method is invoked on a proxy 
instance, the Method object passed to the invocation handler will not necessarily be the one whose declaring class is 
assignable from the reference type of the interface that the proxy's method was invoked through This limitation exists 
because the corresponding method implementation in the generated proxy class cannot determine which interface it 
was invoked through Therefore, when a duplicate method is invoked on a proxy instance, the Method object for the 
method in the foremost interface that contains the method (either directly or inherited through a superinterface) in the 
proxy class's list of interfaces is passed to the invocation handler's invoke method, regardless of the reference type 
through which the method invocation occurred 

If a proxy interface contains a method with the same name and parameter signature as the hashcode, equals, or 
tostring methods of ] ava . iang . object, when such a method is invoked on a proxy instance, the Method object 
passed to the invocation handler will have ]ava . lang .object as its declaring class. In other words, the public, non- 
final methods of java . lang . object logically precede all of the proxy interfaces for the determination of which 
Method object to pass to the invocation handler 

Note also that when a duplicate method is dispatched to an invocation handler, the invoke method may only throw- 
checked exception types that are assignable to one of the exception types in the throws clause of the method in all of 
the proxy interfaces that it can be invoked through If the invoke method throws a checked exception that is not 
assignable to any of the exception types declared by the method in one of the the proxy interfaces that it can be 
invoked through, then an unchecked undeciaredThrowabieException will be thrown by the invocation on the 
proxy instance This restriction means that not all of the exception types returned by invoking getExceptionTypes 
on the Method object passed to the invoke method can necessarily be thrown successfully by the invoke method 

Since: 

JDK1.3 
See Also: 

invocarionHandier , Serialized Form 



Field Summary 

the invocation handler for this proxy instance 
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Constructor Summary 




Proxv 'InvocationHandler h) 

Constructs a new Proxy instance from a subclass (typically, a dynamic proxy class) with the 
specified value for its invocation handler 



Method Summary 




aetlnvocationHandler (Obiect proxy) 

Returns the invocation handler for the specified proxy instance 




qetProxyClass (ClassLoader loader, Class [] interfaces; 

Returns the java. lang. class object for a proxy class given a class loader and an 
array of interfaces 




isProxyClass (Class cl) 

Returns true if and only if the specified class was dynamically generated to be a 
proxy class using the getProxyciass method or the newProxyinstance method 




newProxylnstance ( ClassLoader loader, Class [] interfaces, 
InvocationHandler h) 

Returns an instance of a proxy class for the specified interfaces that dispatches 
method invocations to the specified invocation handler 



Methods inherited from class java.lang. Object 

cl one , equals , fin alize , lass , hashCode , notify , notif vAll , toStnner, wait, wait , wait 



Field Oetail 

h 

protected InvocationHandler h 

the invocation handler for this proxy instance. 

Constructor Detail 

Proxy 

protected Proxy f InvocationHandler h) 

Constructs a new Proxy instance from a subclass (typically, a dynamic proxy class) with the specified value for 

its invocation handler. 

Parameters: 
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h - the invocation handler for this proxy instance 



Method Detail 



getProxyClass 

publ. static Clas s getProxyClass ' Class Loader loader, 

Class [ ] interfaces: 
thro ws 1 1 leg a 1 A r cfume ntExcect i or. 

Returns the ]ava. lang. class object for a proxy class given a class loader and an array of interfaces The 
proxy class will be defined in the specified class loader and will implement all of the supplied interfaces If a 
proxy class for the same permutation of interfaces has already been defined in the class loader, then the existing 
proxy class will be returned, otherwise, a proxy class for those interfaces will be generated dynamicalK and 
defined in the class loader. 

There are several restrictions on the parameters that may be passed to Proxy . getProxyClass 

• All of the class objects in the interfaces array must represent interfaces, not classes or primitive 
types 

• No two elements in the interfaces array may refer to identical class objects 

• All of the interface types must be visible by name through the specified class loader In other words, for 
class loader =i and every interface i, the following expression must be true 

Class . forName fi . get Name ( , false, cl == i 



• All non-public interfaces must be in the same package, otherwise, it would not be possible for the proxy 
class to implement all of the interfaces, regardless of what package it is defined in 

• No two interfaces may each have a method with the same name and parameter signature but different 
return type 

• The resulting proxy class must not exceed any limits imposed on classes by the virtual machine For 
example, the VM may limit the number of interfaces that a class may implement to 65535, in that case, 
the size of the interfaces array must not exceed 65535 

If any of these restrictions are violated, Proxy .getProxyClass will throw an IllegalArgumentException. If 
the interfaces array argument or any of its elements are null, a NuiiPointer Exception will be thrown 

Note that the order of the specified proxy interfaces is significant, two requests for a proxy class with the same 
combination of interfaces but in a different order will result in two distinct proxy classes. 

Parameters: 

leader - the class loader to define the proxy class in 
interfaces - the list of interfaces for the proxy class to implement 
Returns: 

a proxy class that is defined in the specified class loader and that implements the specified interfaces 
Throws: 
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illeqalArqumentException - if any of the restrictions on the parameters that may be passed to 
getProxyciass are violated 

Null Pointer Except ion - if the interfaces array argument or any of its elements are r.„i: 



newProxylnstance 

public static Obje ct newProxylnstance t ClassLoader loader, 

Class [ ] interfaces, 
I nvocationHandier h ) 
throws IlleqalArqumentException 

Returns an instance of a proxy class for the specified interfaces that dispatches method invocations to the 
specified invocation handler. This method is equivalent to 

Proxy. get PrcxyClass (loader, interfaces) . 

getCcnstructor (new Class;] { InvocaticnHandler . class )). 
newlnstance I new Ob]ect[] { handler ]j; 



Proxy . newProxylnstance throws IllegalArgumentException for the same reasons that 
Proxy . getProxyciass does 

Parameters: 

loader - the class loader to define the proxy class in 
interfaces - the list of interfaces for the proxy class to implement 
h - the invocation handler to dispatch method invocations to 
Returns: 

a proxy instance with the specified invocation handler of a proxy class that is defined in the specified 
class loader and that implements the specified interfaces 
Throws: 

Illega lA rgumentException - if any of the restrictions on the parameters that may be passed to 

getProxyciass are violated 

NuiiPomterEx ception - if the interfaces array argument or any of its elements are null, or if the 
invocation handler, h, is null 



isProxyCIass 

public static boolean isProxyCl ass (Class cl) 

Returns true if and only if the specified class was dynamically generated to be a proxy cla? .ising the 

getProxyciass method or the newProxylnstance method 

The reliability of this method is important for the ability to use it to make security decisions, so its 
implementation should not just test if the class in question extends Proxy. 
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Parameters: 

ci - the class to test 
Returns: 

true if the class is a proxy class and false otherwise 
Throws: 

Nul l Point er Except ion - if cl is null 



getlnvocationHandler 

public static Invocation-Handler getlnvocationHandler ( Obi ect proxy, 1 

thro'. 1 1 1 eqalAr gumen t Ex c e o tion 

Returns the invocation handler for the specified proxy instance. 
Parameters: 

proxy - the proxy instance to return the invocation handler for 
Returns: 

the invocation handler for the proxy instance 
Throws: 

I llecralArgument Except ion - if the argument is not a proxy instance 



Overview Package Class Use Tree De preca ted I ndex Help Java™ 2 Platform 

PREV CLASS NEXT CLASS FRAMES NO FRAMES St(L ElL vL3 

SUMMARY: INNER ! FIELD 1 CONSTR METHOD DE Ti 'L FIELD I CQNSTR I METHOD 

Submit a bug or feature 

For further API reference and developer documentation, see Java 2 SDK SE Developer Documentatio n That documentation contains 
more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code 
examples. 

Java. Java 2D. and JDBC are trademarks or registered trademarks of Sun Microsystems. Inc in the US and other countries 
Copyright 1993-2000 Sun Microsystems. Inc. 901 San Antonio Road 
Palo Alto. California. 94303. U.S.A. All Rights Reserved. 
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PREV CLASS NEXT CLASS FRAMES NO FRAMES SttL E(L vl.3 

SUMMARY; INNER i FIELD I CONSTR J METHOD DETAIL FIELD I CONSTR I METHOD 

java.iang. reflect 

Interface InvocationHandler 



public interface InvocationHandler 

invccaticr.Handier is the interface implemented by the invocation handler of a proxy instance 

Each proxy instance has an associated invocation handler When a method is invoked on a proxv instance, the method 
invocation is encoded and dispatched to the invoke method of its invocation handler 



Since: 

CI JDK1 3 

%l See Also: 



p 


:oxv 




Method Summary 




invoke (Obiect proxy, Method method, 0bnect[] aras) 

Processes a method invocation on a proxy instance and returns the result 



Method Detail 



invoke 

public Obiect invoke (Object proxy, 

Method method, 
Obiect [ 1 args) 
throws Throwable 

Processes a method invocation on a proxy instance and returns the result. This method will be invoked on an 

invocation handler when a method is invoked on a proxy instance that it is associated with. 

Parameters: 

proxy - the proxy instance that the method was invoked on 

method - the Method instance corresponding to the interface method invoked on the proxy instance The 
declaring class of the Method object will be the interface that the method was declared in, which may be 
a superinterface of the proxy interface that the proxy class inherits the method through. 
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args - an array of objects containing the values of the arguments passed in the method invocation on the 
proxy instance, or null if interface method takes no arguments. Arguments of primitive types are 
wrapped in instances of the appropriate primitive wrapper class, such as ] ava . lar.g . ir.teaer or 

lava . lang . Boolean 

Returns: 

the value to return from the method invocation on the proxy instance If the declared return type of the 
interface method is a primitive type, then the value returned by this method must be an instance of the 
corresponding primitive wrapper class, otherwise, it must be a type assignable to the declared return 
type If the value returned by this method is null and the interface method's return type is primitive, then 
a NuiiPomterException will be thrown by the method invocation on the proxy instance If the value 
returned by this method is otherwise not compatible with the interface method's declared return type as 
described above, a ciassCastException will be thrown by the method invocation on the prow- 
instance 
Throws: 

T^rowabie - the exception to throw from the method invocation on the proxy instance The exception's 
type must be assignable either to any of the exception types declared in the throws clause of the 
interface method or to the unchecked exception types j ava. lang. RuntimeException or 
ava . lang . Error. If a checked exception is thrown by this method that is not assignable to anv of the 
exception types declared in the throws clause of the interface method, then an 
L^QeciaredThrowabieExcepcion containing the exception that was thrown bv this method will be 
thrown by the method invocation on the proxy instance 
See Also: 

Unde cl a redThrowahle Except! o n 



HI Overview Package Class Use Tree Deprecated Index Help Java™ 2 Platform 

^ c PR ». V fn ASS NEXTCLASS FRAMES NO FRAMES St(L E(L Vl 3 

SUMMARY: INNER ! FIELD I CONSTR | METHOD DETAIL FiEFT^nTtR | METHOD 

O S ubmit a bug or feature ' ~ ' == =^~— 

" more^r T^n^T* d ° CUment f on " see Java 2 SDK Eloper nornm.manon That documentation conta.ns 

m Samples d ^ el °P er - ,ar S eted descnpttons. uith conceptual ovemeus. definitions of terms, workarounds, and working code 

M ? Va - Ja I a a " d are ,rad e™rks or registered trademarks of Sun Microsystems. Inc. m the US and other countries 
Copyright 1 993-2000 Sun Microsystems. Inc 90 1 San Antonio Road ' countries. 

Palo Alto. California. 94303. U S.A All Rights Reserved 
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ntmi 



Package com.gepower.sfo.tool.ldap 



Interface Summary 


DirectoryManager 


DirectoryManager provides an interface for accessing Directory data 


DirectorvSource 


Director/Source is an interface which provides access to Directory data sources 



Class Summary 


DefaultDirectorv Source 


DirectorySource implementation. 


DirectorvEntrv 


Represents an LDAP Directory Entry and a LDAP invocation handler used in Proxy 
instances 


DirectorvManagerFactorv 


Use to create an object which implements the DirectoryManager interface 


Generator 


Generates java interfaces which represents LDAP object classes 
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Overview Package Class Tree De precated Index Help 



PREV PACKAGE NEXT PACKAGE 



FRAMES NO FRAMES 



Package com.gepower.sfo.tool.ldap 



Interface Summary 


DirectorvManager 


DirectoryManager provides an interface for accessing Directory data 


DirectorvSource 


DirectorvSource is an interface which provides access to Directory data sources 



Class Summary 


DefaultDirectorvSource 


DirectorySource implementation. 


DirectorvEntrv 


Represents an LDAP Directory Entry and a LDAP invocation handler used in Prox\ 
instances 


DirectorvManagerFactorv 


Use to create an object which implements the DirectoryManager interface. 


Generator 


Generates Java interfaces which represents LDAP object classes 
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SUMMARY INNER I FIELD I CONSTR i METHOD 



com.geponer.sfo.tool.ldap 

Interface DirectoryManager 



public interface DirectoryManager 

Dire >ryManager provides an interface for accessing Directory data. 



Method Si 


jmmary 




cast : java. lang. Ob}ect entry, j ava . lang . Class interf aceToCastTo ) 

This method provides backward compatibility from Java 1 .3 to Java 1 2 which does not 
support the Proxy class 




getDN { iava . lana. Obnect entrv! 

Use to get the specified 'entry' distinquished name. 




lookup f iava. lana. Strma dr\\ 

Use to lookup a specific entry identified by the specified 'dn'. 




mixinlnterf aces ( j ava . lang . Ob j ect entry, j ava . lang , Class [ ] newlnterf aces 

Use to add additional interfaces specified by 'newlnterfaces' to an existing 'entry' 




newEntrylnstance ( java . lang. String dn, j ava . lang . Class f : interfaces ) 
Use to create a new LDAP entry 




remove n ava. lana. Obi ect entry) 

Use to remove an existing entry from the Directory. 




search*'] ava. lang. String ctxToSearch, java . 1.- .g. String filter) 

Use to execute a query agu:nst the Directory using the specified 'ctxToSearch', and filter' 




search (] ava. lang. String ctxToSearch, java . lang. Sprang filter, 
] avax . naming . directory . SearchControls searchCtrls ) 

Use to execute a query against the Directory using the specified 'ctxTo Search', 'filter*, and 
'searchCtrls. 




search f java. lang. String ctxToSearch, }ava . lang . String filter, 

3^ ^x. naming. directory. SearchControls searchCtrls, : avax . naming . ldap . Control 

L reqCtrls) 

Use to execute a query against the Directory using the specified 'ctxToSearch', 'filter'. 
'searchCtrls, and 'reqCtrls' 
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- 3 write ( ] ava.lang. Object entry) 

Use to commit a new entrv or modifications of an existing entry to the Directory 



Method Detail 

newEntr\ Instance 

publi;- -ava. lang. Object newEntrylnstance ■ ] ava . lang . String dn, 

java. lang. Class [] interfaces 
tnrows j avax . naming . Naming Except ion 

Use to create a new LDAP entry The entry is not written to the Directory until DirectoryManager write() is 

executed 

Parameters: 

dn - Distinquished name for the new entry Must not be null or empty 

interfaces - Array of Class objects which represent the interfaces that this new entry will support The 
Class objects MUST be one of the LDAP code generated interfaces. Array must not be null or empty 
Returns: 

Object representing the directory' entry This object can be cast to the appropriate "objectclass" interface 

(s) 

Throws: 

: avax . naming . NarrmgExcept: ~r. - if a naming excepuon is encountered 



mixinlnterfaces 

.blic java. lang. Object mixinlnterfaces [ j ava . lang . Ob j ect entry, 

j ava . lang . Class [ ] newlnter faces } 
throws j avax . naming . NammgException 



Use to add additional interfaces specified by 'newlnterf aces' to an existing 'entry'. The modified entry is not 

written to the Directory until DirectoryManager. write() is executed. 

Parameters: 

entry - Existing LDAP entry to mix new interfaces into 'entry' must be acquired by calls to 
DirectoryController.lookup(), DirectoryController search(), or DirectoryController newEntryInstance() 
newlnterf aces - Array of new interfaces to mix into the entry Must not be null and must not be empty. 
Returns: 

Object representing the modified directory entry. This object can be cast to the appropriate "objectclass" 
interface(s) including those contained in 'newlnterfaces 1 
Throws: 

j avax . naming . NammgException - if a naming exception is encountered 



lookup 
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public lava . lang . Ob]ect lookup ( j ava . lang . String dn) 

throws lavax. naming. NameNotFoundException, 
j avax . naming . NamingException, 
java . lang . CiassNotFoundException 



Use to lookup a specific entry identified by the specified 'dn' 
Parameters: 

dn - The distinquished name which uniquely identifies the entry Must not be null and must not be empty 
Returns; 

Object representing the diuctory entry bound to the specified dn This object can be ca? r to the 
appropriate "objectclass" interface(s) 
Throws: 

ja -a>:. naming. NameNotFcundExcepcicr. - if dn cannot be resolved because it is not bound 
iava:< . naming. NammgExcepticn - if a naming exception is encountered. 

z ava . lang . ciassNotFoundException - if the looked up entry contains an object class which does . ./t 
have an associated code generated interface 



search 



public 1 ava . utii . List search ( i ava . lang . String ctxToSearch, 

j ava . lang . String filter) 
throws javax . naming . NamingException, 

] ava . lang . CiassNotFoundException 



Use to execute a query against the Directory using the specified 'ctxToSearch', and 'filter' 
Parameters: 

ctxToSearch - Context to search M " for current context Must not be null 
filter - LDAP search filter Must not be null 
Returns: 

List of Objects representing the results of the sea: Sn These Object can each be cast to the appropriate 
"objectclass" interface(s). If search finds nothing, List returned will have size of zero. Return will never 
be null 
Throws: 

iava . lang. CiassNotFoundException - if the entries found contains an object class which does not 
have an associated code generated interface. 

javax. naming. NamingException - if naming exception is encountered. 



search 

public iava . utii . List search (] ava . lang . String ctxToSearch, 

j ava . lang . String filter, 

javax. naming. directory. SearchCont rois searchCtrls ) 
throws i avax . naming . NamingException, 

] ava . lang . CiassNotFoundException 
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Use to execute a query against the Directory using the specified 'ctxToSearch'. 'filter', and 'searchCtrls 
Parameters: 

ctxToSearch * Context to search ,,H for current context. Must not be null 
filter - LDAP search filter Must not be null 

searchctris - Used to determine scope of search and what gets returned May be null If null defaults 
will be used (search using SearchControls SUBTREE_SCOPE) 
Returns: 

List of Objects representing the results of the search These Object can each be cast to the appropriate 
"objectclass" interface(s). If search finds nothing, List returned will have size of zero Return wii! never 
be null. 
Throws: 

java.iang.ci-ssNotFoundException - if the entries found contains an object class which does not 
have an associated code generated interface 

javax. naming. NamingException - if naming exception is encountered. 
See Also: 

SearchControls 



search 

public 1 ava . ueii . Lis t search {j ava . lane . S :r;ng ctxToSearch, 

java . lang . S tiring filter, 

javax . naming . directory . SearchControls searchctris , 
javax . naming . idap . Control [ ] reqCtrls ) 
throws javax. naming . NamingException, 

java . iang . Cias sNotFoundExcep tion 

Use to .xecute a query against the Director using the specified 'ctxTo Search', 'filter'. 'searchCtrls, and 

'reqCtrls* 

Parameters: 

ctxToSearch - Context to search for current context. Must not be null, 
filter - LDAP search filter. Must not be null. 

searchctris - Used to determine scope of search and what gets returned May be null. If null, defaults 
will be used (search using SearchControls. SUBTREE_SCOPE) 

reqctris - A control to request the LDAP search to return in a certain way (i.e, sort results in a 
particular way) May be null. If null, no LDAP request controls will be used 
Returns: 

List of Objects representing the results of the search. These Object can each be cast to the appropriate 
"objectclass" interface(s). If search finds nothing, List returned will have size of zero. Return wilt never 
be null. 
Throws: 

java. iang. ciassNotFoundException - if the entries found contains an object class which does not 
have an associated code generated interface. 

javax. naming. NamingException - if naming exception is encountered 
See Aiso: 

SearchControls, Control 
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write 

public void write : ava . lang . Ob j ect entry) 

throws ] avax . naming . NamngException 

Use to commit a new entry or modifications of an existing entry to the Directory 
Parameters: 

entr- Entry to commit to the directory 'entry' must have been acquired b> calls to 
DirectoryController lookupO, DirectoryController search(), or DirectoryController newEntrylnstancei ) 
Must not be null 
Throws: 

i avax. naming. NamingException - if naming exception is encountered. 



remove 

public void remove; j ava. lang. Object entry) 

tnrows ] avax . naming . NamingException 

Use to remove an existing entry from the Directory. 
Parameters: 

entry - Entry to remove from the directory 'entry' must have been acquired by calls to 
DirectoryController lookupO, DirectoryController search(), or DirectoryController newEntrylnstanceO 
Must not be null 
Throws: 

i avax . naming . NamingException - if naming exception is encountered 



cast 

public java. lang. Object cast { j ava . lang . 0b ject entry, 

java. lang. Class inter faceToCastTo ) 
throws java . lang . ClassCast Except ion 

This method provides backward compatibility from Java 1.3 to Java 1.2 which does not support the Proxy 

class This method is not yet implemented 

Parameters: 

entry - Entry to cast, 'entry* must have been acquired by calls to DirectoryController. lookupO, 
DirectoryController. search(), or DirectoryController newEntrylnstanceO Must not be null 
interf aceToCastTo - This is the interface that the specfied 'entry 1 is to be cast to. 
Returns: 

Object which can be cast to the type specified by 'interfaceToCastTo' 
Throws: 

j ava . lang . classCastException - if the specified 'entry' cannot be cast to the specified 
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'interfaceToCastTo* 



getDN 

public java.lang. String getDN ( j ava . lang . Obi ect entry) 

Use to get the specified 'entry' distinquishe ' lame. 
Parameters: 

entry - Entry to obtain distinquished name from 'entry' must have been acquired by calls to 
DirectoryController.lookupO, Direct on/Controller. search(), or DirectoryController ne\vEntryInstance( ) 
Must not be null 
Returns: 

String containing the specified 'entry' distinquished name. 



Overview Package Class Tree De precated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 
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com.gepowensfo.tooLldap 

Class DefaultDirectorySource 

j ava . lang . Gbiect 

—-com. gepower . sf o . toe' . ldap . DefaultDirectorySource 

AH Implemented Interfaces: 

DirectorvSou rce 



public class DefaultDirectorySource 

~. extends java.lang. Object 
implements DirectorvSource 

yi DirectorvSource implementation. See DirectorvSource for discription of implemented methods 



Constructor Summary 

Defaul tDirectorySource ; java . util . Kashtacie environment } 



Method Summary 




discardDirContext (iavax.namina.directory.ni rr.ontPYt rr*ni-*»xi-) 
Use to discard the specified 'context'. 




qetDirContext f ) 

Use to get a JNDI DirContext object. 


void 


releaseDir Con text { i avax . naraina . di renrnry . Di rC^r^yt- ™ n i-o V i- } 

Use to release the specified 'context*. 



Methods inherited from class java Jan g.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAii, toStrmgT 



Constructor Detail 
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DefaultDirectorySource 

public DefaultDirectorySource (java. cil . Hashtable environment 

throws j avax . naming . KammgExcepticr. 



Method Detail 



getDirContext 

oubli z z a vax . naming . directory . DirContext getDirContext ' ) 

throws j avax . naming . N T aming£xcept ion 

Description copied from interface: DirectorvSource 

Use to get a JNDI DirContext object 
Specified by: 

qetDirCcncex : in interface Di rectorvSource 
Following Copied from interface com. gepower . sfo . tool . Idap. DirectoryScur :e 

Returns: 

DirContext object 
Throws: 

] avax . naming . NamingException - if a naming exception is encountered. 



releaseDirContext 

public void releaseDirContext {j avax. naming. directory. DirContext context' 

Description copied from interface: DirectorvSource 

Use to release the specified 'context' This should be called when the context is no longer needed. 
Specified by: 

releaseDirContext in interface DirectorvSource 
Following copied frc: ^ interface' com. gepower. sfo. tool. idap. DirectorySource 

Parameters: 

context - The context to release 



discardDirContext 

public void discardDirContext (] avax. naming . directory . DirContext context) 

Description copied from interface: DirectorvSource 

Use to discard the specified 'context' 
Specified by: 

discardDi rContext in interface DirectorySource 
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Fallowing copied from interface: com.gepower.sfo. tool.ldap.DirectorySource 

Parameters: 

context - The context to release 

Overview Packag e Class Tree Deprecated Index Help 

PREV CLASS NEXTCLASS FRAMES NO FRAMES 

SUMMARY INNER ' FIELD j CONSTR i MET HOD DETAIL FIELD I CONST R , METHOD 
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com.gepower.sfo.tool.Idap 

Class DirectoryEntry 

j ava . lang . Osiect 

i— com. gepower . sf o . tool . Idap . DirectoryEntry 

AH Implemented Interfaces: 

Java lang. reflect InvocationHandler, Java io.Serializable 



public class DirectoryEntry 

extends java lang Obiect 

implements Java io Serializable, java lang reflect. InvocationHandler 

Represents an LDAP Directory Entry and a LDAP invocation handler used in Proxy instances Each proxy instance 
has an associated invocation handler. When a method is invoked on a proxy instance, the method invc :ion is 
encoded and dispatched to the invoke method of its invocation handler. This is a package scope class and not used 
directly by clients 

See Also: 

InvocationHandler, j ava . lang . reflect . Proxy, Serialized Form 



Method Summary 




invoke { lava . lanq . Obiect proxy, i ava . lanq . reflect . Method method, 
] ava . lang . Ob j ect [ ] args) 

Implement abstract method invoke() from InvocationHandler 




toStrinp;( lava. lanq. Obi ect proxy, i ava . lanq . reflect . Method method) 
Returns the contents of all attribute in this entry 



Methods inherited from class javaJang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAU, toStnng, wait, wait, wait 



Method Detail 
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invoke 

public java. lang. Object invoke { ] ava . lang . Obj ect proxy, 

] ava . lang . reflect . Method method, 
j ava . lang .Object ; ] args ) 
throws j ava . lang . Throwable 

Implement abstract method invoke() from InvocationHandler This method only recognizes methods that have 
been declared in the generated interfaces. 
Specified by: 

invoke in interface j ava . lang . reflect . InvocationHandler 

Parameters: 

proxy - the proxy instance that the method was invoked on. 

method - the Method instance corresponding to the interface method invoked on the proxy instance The 
declaring class of the Method object will be the interface that the method was declared in, which may be 
a superinterface of the proxy interface that the proxy class inherits the method through, 
args - an array of objects containing the values of the arguments passed in the method invocation on the 
proxy instance, or null if interface method takes no arguments. Arguments of primitive types are 
wrapped in instances of the appropriate primitive wrapper class, such as Java. lang. Integer or 
java lang. Boolean. 
Throws: 

java . lang . Throwable - the exception to throw from the method invocation on the proxy instance The 
exception's type must be assignable either to any of the exception types declared in the throws clause of 
the interface method or to the unchecked exception types java lang RuntimeException or java lang Error 
If a checked exception is thrown by this method that is not assignable to any of the exception types 
declared in the throws clause of the interface method, then an UndeclaredThrowableException 
containing the exception that was thrown by this method will be thrown by the method invocation or "he 
proxy instance 
See Also: 

j ava . lang . reflect . UndeclaredThrowableException 



toString 

public java. lang. String toString ( j ava . lang . C~ j ect proxy, 

j ava . lang . reflect . Method method) 

Returns the contents of all attribute in this entry Use for debugging purposes only 
Parameters: 

proxy - The Proxy object serviced by this InvocationHandler. 
method - The Method object invoked on the Proxy 
Returns: 

The contents of all attributes in this entry. 
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Overview Package Class Tree Deprecated Index Help 



P REV CLASS NEXT CLASS 
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FRAMES NO FRAMES 

DETAIL FIELD I CONSTR 1 METHOD 



com. gepow er.sfo.tool.ldap 

Class DirectoryManagerFactory 

j ava . Iang . Cb? ect 

---com. gepower . sf o . tool . ldap .DirectoryManagerFactory 



public class DirectoryManagerFactory 

extends java.lang.Object 

Use to create an object which implements the DirectoryManager interface. 



Constructor Summary 



Director y Manage rFac tory • 



Method Summary 



newDirectorvManager i direct or vSource src, ] ava . Iang . String pkg) 

Creates a new object which implements the DirectoryManager interface using the 
specified src' and 'pkg'. 



newDirectorvManager [ DirectorvSource src, java . Iang. String pkg, 
java . Iang . ClassLoader loader) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'src', 'pkg', and 'loader'. 



newDirectoryManaqer f Di_ r ctorySource src, ] ava . Iang . String pkg, 
java.lang.ClassLoader loader, j ava . 10 . PrmtStream logger) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'src', 'pkg', 'loader', and 'logger' 



newDirectoryManaqer f ] ava . util . Hashtabie env, j ava . Iang . St ring pkg) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'env' and 'pkg' 
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newDirectoryManager h ava . util . Hashtable env, ]ava . lang . String p^g, 
1 ava . lang . ClassLoader loader' 1 

Creates a new object which implements the Director/Manager interface using the 
specified 'env', 'pkg\ and loader' 




newDirectorvManaqer i ava . util . Hash table env, n ava . lane . St ring pkg, 
j ava . lang . ClassLoader loader, ] ava . 10 . PrintStreait logger 

Creates a new object which implements the DirectoryManager interface using the 
specified 'env', 'pkg', 'loader', and 'logger'. 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, nashCode, notify, notifyAll, tcStrir.g, wait, 



Constructor Detail 



DirectoryManagerFactory 

11 public DirectoryManagerFactory { ) 



Method Detail 



newDirectoryManager 

public static DirectoryManager newDirectoryManager ( j ava . util . Has ht able env, 

3 ava . lang . String pkg; 
throws ] ava . lang . IliegalArgumentException, 
] a vax . naming . NammgException 

Creates a new object which implements the DirectoryManager interface using the specified 'env' and 'pkg' 
Parameters: 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed. Must not be null. 

pkg - The Java package in which the LDAP interfaces were generated under. Must not be null 
Throws: 

java . lang . IliegalArgumentException - if 'env ! or 'pkg 1 is null. 

javax. naming. NamingException - if a naming exception is encountered. 



newDirectoryManager 

public static Dire ctoryManager newDirectoryManager { j ava . util . Hashtable env, 

j ava . lang . String pkg, 
java. lang. ClassLoader loader) 
throws java . lang . IliegalArgumentException, 
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j avax . naming . NamingException 

Creates a new object which implements the DirectoryManager interface using the specified 'env', 'pkg'. and 

'loader' 

Pa ra m e terse 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed Must not be null 

pkg - The java package in which the LDAP interfaces were generated under Must not be null 
loader - Class loader u use to load proxy classes May be null in which case the current threads class 
loader will be used 
Throws: 

nava . lang. IllegalArgumentException - if 'env' or 'pkg' IS null. 

j avax . naming . NamingException - if a naming exception is encountered. 



newDirectoryManager 

public static DirectoryManager newDirectoryManager java. util . Hasht able env, 

j ava . lang . String pkg, 
java. lang. ClassLoader loader, 
java . io . PrintStream logger) 
throws java « lang . IllegalArgumentException, 
j avax . naming . NamingException 

Creates a new object which implements the DirectoryManager interface using the specified 'env', 'pkg 1 , 'loader, 

and 'logger'. 

Parameters: 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed Must not be null 

P .<g - The java package in which the LDAP interfaces were generated under Must not be null 
loader - Class loader to use to load proxy classes. May be null in which case the current threads class 
loader will be used 

logger - This is where all debug trace messages will be written to. 
Throws: 

j ava. lang. IllegalArgumentException - if f env' or 'pkg' is null 

j avax . naming . NamingException - if a naming exception is encountered. 



newDirectoryManager 

public static DirectoryManager newDirectoryManager ( Pi recto rySource src, 

java . lang . String pkg; 
throws ]ava . lang . IllegalArgumentException, 
3 avax . naming . NamingException 

Creates a new object which implements the DirectoryManager interface using the specified 'src' and 'pkg'. 
Parameters: 

src - Specifies the what directory source the DirectoryManager will use. Must not b^ null. 
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pkg - The Java package in which the LDAP interfaces were generated under Must not be null 
Throws: 

nava.lana. IllegalArgumentException - if 'src' or pkg IS null. 

3 avax. naming. NamxngException - if a naming exception is encountered. 



newDirectoryManager 

Dub ii c static Direct oryManager newDirectoryManager f Dire ctoryS our ce src, 
* " " ]ava.iang. String pkg, 

i ava . lang . Class Loader leader 
throws ] ava . lang . IllegalArgumentExc -ption, 

3 avax . naming . NammgExcepticr. 

Creates a new object which implements the DirectoryManager interface using the specified 'src'. 'pkg. and 

'loader' 

Parameters: 

src - Specifies the what diiectory source the DirectoryManager will use. Must not be null, 
pkg - The java package in which the LDAP interfaces were generated under Must not be null, 
loader - Class loader to use to load proxy classes. May be null in which case the current threads class 
loader will be used. 
Throws: 

java. lang. IllegalArgumentException - if 'src' Or 'pkg' is null. 

: avax . naming . NammgExcepticn - if a naming exception is encountered 



newDirectoryManager 

Dire e tc rvManaqer newDirectoryManager ( DirectorySource src, 

j a va . lang . String pkg, 
] ava . lang . Class Loader loader, 
java.io.PrintStream logger) 
throws java. lang. IllegalArgumentException, 
j avax . naming . NamingException 

Creates a new object which implements the DirectoryManager interface using the specified 'src*, 'pkg', 'loader', 
and 'logger' 
Parameters: 

src - Specifies the what directory source the DirectoryManager will use. Must not be null, 
pkg - The java package in which the LDAP interfaces were generated under. Must not be null, 
loader - Class loader to use to load proxy classes. May be null in which case the current threads class 
loader will be used. 

logge - This is where all debug trace messages will be written to. 
Throws: 

iava . lang . IllegalArgumentException - if 'src' Or 'pkg' is null. 
i avax . naming . Narr.-ng Except ion - if a naming exception is encountered 



oublic stat] 
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PREV CLASS NEXT CLASS 



SUMMARY: INNER 
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com.gepower.sfo.tool.ldap 

Class Generator 

java. lang. Object 

h com. gepower . s£o . tool . Idap . Generator 



public abstract class Generator 
extend s j ava. lang . Obj ect 

Generates java interfaces which represents LDAP object classes. These classes are used in the java LDAP Directory 
framework. This class is abstract can contains only static methods. This class contains a main() method and is 
designed to be executed from the command line See method description for main() for more details 

See Also: 

main ( i ava . Ian a . St ring [ ] ) 



Constructor Summary 

Generator ( ) 



Method Summary 




main ( 1 ava . lang . String [ ] args ) 

Usage: java com.gepower.sfo tool. Idap. Generator params [options] 



Methods inherite d from class java.lang.Obj ect 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 



Constructor Detail 

Generator 

public Generator ( ) 
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1 Method Detail _ 1 

main 

public static void main ( j ava . lang . String [ ] args} 

Usage: java com.gepower.sfo.tool.ldap Generator params [options] 

To print out .ielp, use the -help option when executing this program from the command line 

Parameters: 

args - Array of String arguments which consists of the required and optional parameters 

Required Parameters 

• '-sourcerootpath' the root directory path for the generated java source 

• -package' the java package for the generated java source 

• -dirctxfactory' class to use for the initial directory context factory 

• '-providerurl' the LDAP URL string (i.e , ldap ,71ocalhost.389/o=ge com) 

• -securityprincipaT identity of the principal for authenticating the caller to the service 

• '-securitycredentials' credentials of the principal for authenticating the caller to the service 

• '-securityauthentication' security level to use 

Optional Parameters: 

• '-exclude' object classes matching the wildcard will be excluded from code generation Exclusions 
have precedence over Inclusion. Multiple wildcards can be specified separated by semi-colons (i e, 
"ns*; ob*; net*server") 

• '-include' object classes matching the wildcard will be included in code generation If option not 
specified, include all object classes Multiple wildcards can be specified, see exclude option 

• '-version' version number that will be included into the javadoc of the generated code 

• '-tabstop 1 tab stop to use when formatting the generated code 

• '-help' use to print usage syntax on the command line 

• l - 9 ' use to print usage syntax on the command line 



Overview Package Class Tree Deprecated I ndex Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER [ FIELD | CONSTR | METHOD DETAIL FIELD | CONSTR j METHOD 
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